home *** CD-ROM | disk | FTP | other *** search
/ Aminet 52 / Aminet 52 (2002)(GTI - Schatztruhe)[!][Dec 2002].iso / Aminet / dev / gg / bing-1.1.3.lha / bing-1.1.3 / src / win32 / bing.txt next >
Text File  |  1997-06-06  |  7KB  |  202 lines
  1.  
  2.  
  3.  
  4. BING(8)            UNIX System Manager's Manual           BING(8)
  5.  
  6.  
  7. NAME
  8.        bing  -  compute point to point throughput using two sizes
  9.        of ICMP ECHO_REQUEST packets to pairs of remote hosts.
  10.  
  11. SYNOPSIS
  12.        bing [dDnrRPvVwz] [-c count] [-e samples] [-f samplefile]
  13.        [-i wait] [-p pattern] [-s small packetsize] [-S big pack-
  14.        etsize] host1 host2 [...]
  15.  
  16. DESCRIPTION
  17.        Bing determines bandwidth  on  a  point-to-point  link  by
  18.        sending  ICMP  ECHO_REQUEST  packets  and  measuring their
  19.        roundtrip times for different packet sizes on each end  of
  20.        the link.
  21.  
  22.  
  23.        host1 is supposed to be the nearest end of the link, while
  24.        host2 is the other end.
  25.  
  26.        The options are as follows:
  27.  
  28.        -c count
  29.             Stop after count resets of the stats. Useful only  in
  30.             conjunction with the -e option. Defaults to 1.
  31.  
  32.        -d   Set the SO_DEBUG option on the socket being used.
  33.  
  34.        -D   Display  the  measured  throughput  at every received
  35.             packet. By default, it is  displayed  only  when  the
  36.             computed  value  changes,  which  itself changes only
  37.             when the minimum roundtrip time for one of the packet
  38.             sizes changes.
  39.  
  40.        -e samples
  41.             Reset  stats after sending samples ECHO_REQUEST pack-
  42.             ets.
  43.  
  44.        -f samplefile
  45.             Saves the bandwidth measurements to the file  sample-
  46.             file.
  47.  
  48.        -i wait
  49.             Wait  wait  seconds  for  each ECHO_REPLY packet. The
  50.             default is to wait for four seconds.
  51.  
  52.        -n   Numeric output only.  No  attempt  will  be  made  to
  53.             lookup symbolic names for host addresses.
  54.  
  55.        -P   Be pedantic regarding round-trip times.
  56.  
  57.             Normally,  bing assumes that the roundtrip time for a
  58.             small  packet  should  always  be  smaller  than  the
  59.             roundtrip  time  for  a  big packet to the same host,
  60.             that for a given size the roundtrip  time  for  host1
  61.  
  62.  
  63.  
  64.                           April 3, 1995                         1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. BING(8)            UNIX System Manager's Manual           BING(8)
  71.  
  72.  
  73.             should  always be smaller than the roundtrip time for
  74.             host2, and that the increase in  the  roundtrip  time
  75.             between  host1  and host2 should always be bigger for
  76.             big packets than for small packets.
  77.  
  78.             bing takes advantage of this to better determine  the
  79.             minimum roundtrip times.
  80.  
  81.             Option  -P  disables  this behaviour, in the unlikely
  82.             event it could be of any  use  someday.  Even  IP/X25
  83.             links are not weird enough to require this, though.
  84.  
  85.        -p pattern
  86.             You  may  specify  up to 16 ``pad'' bytes to fill out
  87.             the packet you send.  This is useful  for  diagnosing
  88.             data-dependent  problems  in a network.  For example,
  89.             ``-p ff'' will cause the sent  packet  to  be  filled
  90.             with all ones.
  91.  
  92.        -R   Record route. Includes the RECORD_ROUTE option in the
  93.             ECHO_REQUEST packet and displays the route buffer  on
  94.             returned  packets.  Note  that  the IP header is only
  95.             large enough for nine such routes. Many hosts  ignore
  96.             or discard this option.
  97.  
  98.        -r   Bypass the normal routing tables and send directly to
  99.             a host on an attached network. If the host is not  on
  100.             a  directly-attached  network,  an error is returned.
  101.             This option can be used to ping a local host  through
  102.             an  interface  that  has  no  route through it (e.g.,
  103.             after the interface was dropped by routed(8)).
  104.  
  105.        -s small packetsize
  106.             Specifies the number of data bytes to be sent in  the
  107.             small packets. The default and minimum value is 44.
  108.  
  109.        -S big packetsize
  110.             Specifies  the number of data bytes to be sent in the
  111.             big packets. The default is 108. The size  should  be
  112.             chosen  so  that  big packet roundtrip times are long
  113.             enough to be accurately measured (depending on  clock
  114.             resolution and number of hops).
  115.  
  116.        -u size increment
  117.             Specifies  that  bing should start sending packets of
  118.             the size of small packetsize and  then  increase  the
  119.             size  by  size increment until it reaches big packet-
  120.             size.
  121.  
  122.        -v   Verbose output. ICMP packets other than ECHO_RESPONSE
  123.             that are received are listed.
  124.  
  125.        -V   Very  verbose  output.  The  roundtrip  time  of each
  126.             received echo is displayed.
  127.  
  128.  
  129.  
  130.                           April 3, 1995                         2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. BING(8)            UNIX System Manager's Manual           BING(8)
  137.  
  138.  
  139.        -w   Display possible warnings about roundtrip  times  all
  140.             the  time.   By default, warnings are printed only at
  141.             the end.
  142.  
  143.        -z   Fill  packets  with  uncompressible   (pseudo-random)
  144.             data.
  145.  
  146.        Round-trip  times and packet loss statistics are computed.
  147.        If duplicate packets are received, they are  not  included
  148.        in  the  packet  loss calculation, although the round trip
  149.        time of these packets is used  in  calculating  the  mini-
  150.        mum/average/maximum  round-trip  time  numbers.  When  the
  151.        specified number of loops have been made or if the program
  152.        is terminated with a SIGINT, a brief summary is displayed.
  153.  
  154.        This program is intended for use in network testing,  mea-
  155.        surement and management. Because of the load it can impose
  156.        on the network, it is unwise to  use  bing  during  normal
  157.        operations or from automated scripts.
  158.  
  159. BUGS
  160.        Many Hosts and Gateways ignore the RECORD_ROUTE option.
  161.  
  162.        The maximum IP header length is too small for options like
  163.        RECORD_ROUTE to be completely  useful.  There's  not  much
  164.        that that can be done about this, however.
  165.  
  166.        Some of the final stats (average throughputs) almost never
  167.        give a even marginally correct result.
  168.  
  169. SEE ALSO
  170.        netstat(1), ifconfig(8), ping(8), routed(8), traceroute(8)
  171.  
  172. AUTHOR
  173.        Pierre Beyssac <pb@fasterix.freenix.fr>
  174.  
  175.        Port to Windows: Francois Gouget <fgouget@mygale.org>
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.                           April 3, 1995                         3
  200.  
  201.  
  202.